.TH std::experimental::filesystem::path::relative_path 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::experimental::filesystem::path::relative_path \- std::experimental::filesystem::path::relative_path

.SH Synopsis
   path relative_path() const;  (filesystem TS)

   Returns path relative to root path. If *this is an empty path, returns an empty
   path.

.SH Parameters

   \fI(none)\fP

.SH Return value

   Path relative to the root path.

.SH Exceptions

   May throw implementation-defined exceptions.

.SH Example


// Run this code

 #include <experimental/filesystem>
 #include <iostream>
 namespace fs = std::experimental::filesystem;

 int main()
 {
     fs::path p = fs::current_path();

     std::cout << "The current path " << p << " decomposes into:\\n"
               << "root-path " << p.root_path() << '\\n'
               << "relative path " << p.relative_path() << '\\n';
 }

.SH Possible output:

 The current path "C:\\Users\\abcdef\\Local Settings\\temp" decomposes into:
 root-path "C:\\"
 relative path "Users\\abcdef\\Local Settings\\temp"

.SH See also

   root_name      returns the root-name of the path, if present
                  \fI(public member function)\fP
   root_directory returns the root directory of the path, if present
                  \fI(public member function)\fP
   root_path      returns the root path of the path, if present
                  \fI(public member function)\fP

.SH Category:
     * Noindexed pages
